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Preface 



Prerequisite documents 



Companion Documents 



This document explains how to use the network facilities available on the Sun 
Workstation. We assume that you have a fair amount of experience with the Sun 
Workstation, and the SunOS operating system. 

We provide examples so you can learn how to log in to and execute commands 
on remote machines, as well as to gain dialup access to a machine. However, we 
don’t present detailed explanations of the inner workings of the network pro- 
grams. As in each of the Beginner’s Guides, we refer to the other Sun documen- 
tation, drawing a road map for you to follow when you wish to learn more about 
a certain topic. 

In addition to explaining remote logins, remote command execution, and dialup 
access. Using the Network: Beginner’s Guide provides a command summary and 
glossary for easy access to the material. 

We suggest you read the Beginner’s Guides in the following order: 

Getting Started with SunOS: Beginner’s Guide 

SunView 1 Beginner’s Guide 

Mail and Messages: Beginner’s Guide 

Using the Network: Beginner’s Guide 

Setting Up Your SunOS Environment: Beginner’s Guide 

Doing More with SunOS: Beginner’s Guide 

Self-Help with Problems: Beginner’s Guide 

You will also find the following manuals to be useful: 



SunOS Reference Manual 
System and Network Administration 



1 



Overview 



Overview 



3 



1.1. What Is a Network? 3 

NFS 3 

The Yellow Pages 6 





Overview 



Networks provide you with the opportunity to use other machines while logged 
in on your own machine. You can log in to other machines, or you can execute 
commands without logging in to other machines. 



1.1. What Is a Network? A network is a connection between machines, allowing them to transmit informa- 
tion to one another. Networks are often referred to as being local area networks 
(LANs), which range over a small area, generally less than a few thousand feet; 
wide area networks (WANs), which can span thousands of miles; or campus area 
networks (CANs), which are intermediate in size. 

Networks may themselves be groups of networks; such a super-network is called 
an internetwork. For example, you may be part of a network of machines on 
your building’s floor, and part of an internetwork connecting your local network 
with similar networks across the country. As the difference between a network 
and an internetwork is generally invisible to the user, we will use the term "net- 
work" to refer to both networks and internetworks. 

Machines participating in a network communicate using a network protocol, or 
shared network language, to transmit the appropriate information to the right 
place. An internetwork protocol — sometimes referred to as a gateway or relay 
— links networks together. 

NFS If you are using a Sun Workstation, you are not necessarily on a network. You 

may, for example, bring you machine up single-user, or you may simply be on a 
machine which is not connected to any network. 

Still, most Sun users are on a network of one sort or another. The Network File 
System, or NFS™, allows users on different machines to share files across a net- 
work . 1 NFS is both a communications protocol — a set of rules machines follow 
for talking with each other — and a collection of software utilizing that protocol. 
NFS makes use of services provided by a network to allow for transparent transfer 
and access of files between machines; that is, NFS allows you to treat some files 
on other machines as though they were on your own machine. NFS was 
developed by Sun Microsystems and has been adopted by a number of other 
companies. 



1 NFS is a trademark of Sun Microsystems. 
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4 Using the Network 



NFS is not limited to machines which run SunOs; many other systems, from per- 
sonal computers to super-computers, can use it to share files across a network. 

NFS doesn’t exist on the network — a network is just a lifeless collection of 
wires, cables, phones, and other communications devices. Rather, each machine 
utilizing NFS runs its own set of the NFS daemons. (A daemon — sometimes 
known as a server 2 — is a program which runs on your machine, doing various 
specific housekeeping chores. A printer daemon might handle the queueing up 
and printing of files, while a mail daemon takes care of sending messages back 
and forth between users. Most daemons are invisible to the user.) 

Traditionally, a multi-user system had a single processor (or set of processors) 
and disks serving a number of users: 

Figure 1-1 A Non-Network Environment 




The problem with the set-up in Figure 1-1 is that all the users are competing for 
the same processor. With a network of workstations, however, each user has his 
or her own central processor, and can access files located on other machines. NFS 
allows files to be scattered among the various machines on the network, so to the 
user the whole network appears somewhat like one big computer: 



2 The word server has several definitions; see the glossary. 
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Figure 1-2 A Typical Network Set-Up 



workstation 




workstations 




workstation 















Network 




workstation! 
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A file system, (aka filesystem) is the 
files and subdirectories, with their 
corresponding files, contained in a 
directory. For example, everything 
in /usr and its subdirectories 
makes up the /usr file system. 



Using NFS, you can get access to other machine’s files by mounting file systems 
on those machines. Chapter 3 gives an introduction to mounting remote file sys- 
tems; for a fuller discussion of NFS, see the Network Programming manual. On 
the Sun386i, mounting is done automatically, so you can skip this section. 



Types of Networks 



Some common networks you may encounter include: 

Local Area Networks 

As mentioned earlier, small networks are sometimes called Local Area Net- 
works (LANs). In local area networks, machines are connected by cables. 
Two types of LAN networks common to Sun machines are based on Ethernet 
and (soon) FDDI technologies; you may, for example, hear references to 
“sending something over the Ethernet.” Such networks allow real-time com- 
munication between machines, so you can log in directly to another machine 
and run programs as though it were in front of you. You can also copy files 
to and from remote machines on a LAN. 

ARPANET-Based Networks 

In 1969 the Advanced Research Projects Agency (ARP A) of the U.S. Depart- 
ment of Defense sponsored the development of the a broadscale communica- 
tion network. Today there are a number of networks which use ARPANET 
technology; among the best-known and most-accessible is the Defense Data 
Network, which consists of two networks, the ARPANET and the MILNET. 
Beyond this is the Internet, which is a number of networks connected to the 
DDN using the Internet Protocols. 

Users on machines that attach directly to the network, by cables or 
microwave connections, can log in “real-time” to other machines on the 
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network. 

UUCP Network 

The UUCP network is not permanent system of hardware connecting 
machines, but a program which allows machines to use telephones to 
transmit data, thus creating a sort of ad hoc network each time the program 
is invoked. (People disagree whether on whether it should be considered a 
network at all.) You can use UUCP to communicate with machines across the 
United States and throughout the world. 

An ad hoc UUCP network is not a real-time network like a LAN network; in 
other words, you can’t log in to another machine using UUCP. However, you 
can send information, like mail messages, to other machines and receive 
answers back from them. 

Because UUCP is not a real-time network, most of the information in this 
manual, such as logging in to remote machines, copying from other 
machines, and issuing commands to other machines, does not apply to it. 

For information about how to send and receive mail messages on the UUCP 
network, see Mail and Messages: Beginner’s Guide. 

People using machines on a UUCP network sometimes can send mail messages 
over ARPANET-based networks by utilizing a mail gateway, a machine that 
transfers data from one network to another. 3 

The Yellow Pages Because networks can get very large, doing system administration on them can 

get quite complicated: one needs to keep track of who belongs to a network, who 
has permissions to access which filesystems, and so on. For this reason, Sun pro- 
vides the Yellow Pages (YP). The Yellow Pages is a network database lookup 
service. That is, it maintains certain files with information about the machines 
which belong to the network and their users, and it provides users all over the 
network with the ability to look up the information contained in those files. By 
default there are a number of databases in the Yellow Pages, although a System 
Administrator may delete or add databases as desired (except on the Sun386i). 
These default databases include hosts, which has machine names along with 
their addresses on the network; passwd, which, like your local /etc/passwd 
file, contains password and other information associated with usernames; 
group, which holds the various groups that users have divided themselves into; 
and aliases, which contains mail aliases that the network recognizes. Not all 
systems mn the YP — ask your System Administrator if yours does. 4 

The Yellow Pages is a distributed database; that means that copies of its data 
files are kept in various places throughout the network, for faster access by users. 
(There is one central, master copy, and changes to it are propagated by YP down 
to the other “slave” copies.) The Yellow Pages lookup service revolves around 
two daemons: ypserv, which is the lookup function on the machine which has 



Note: UUCP is an abbreviation for 
the unix to UNIX CoPy program that 
machines based on the unix sys- 
tem, including Suns, employ to 
"talk” with each other. 



3 For information about how to send and receive mail messages on ARPANET-based networks, see Mail and 
Messages: Beginner s Guide . 

4 All Sun386i systems run the Yellow Pages. 
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a copy of the Yellow Pages, and ypbind, which lives on your machine and con- 
nects it to ypserv. In order to use the Yellow Pages database, these two dae- 
mons must be running. To find out if your machine is using the Yellow Pages, 
use the ps and grep commands; you should see something like this: 

venus% ps -aux | grep ypbind ' 

root 27 0,0 1,1 66 34 ? I 6 : 15, /tisr/ etc/ypbind 

venus % • . . ■ . • 



(Y ou can use ps -aux to check for the presence of any daemon, including the 
NFS daemons.) 

You may never need to access the YP files; generally only System Administra- 
tors ever tinker with them. However, you may occasionally want to read these 
files. Some commands to help you include the following: 

ypcat 

This displays the YP data file you name. You can pipe it to the grep com- 
mand to find the entries you want. 

ypmatch 

ypmat ch looks up an entry, or "key," in a the YP database file you specify, 
ypwhich 

This command tells you which YP server supplies Yellow Pages services for 
your machine. 

yppasswd 

You use yppasswd to change your network, as opposed to your machine’s, 
password. (Often they’re the same.) 

For further information on these commands, type man followed by the 
command’s name. For a fuller treatment of the Yellow Pages, type man 
ypf lies or consult the Network Programming manual . 
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Login Access to Other Machines 



2.1. Trust Amongst 
Machines on a 
Network 



/etc/hosts 



You can log in from your machine to another machine using one of these pro- 
grams: 

rlogin from one machine running an operating system based on 

the UNIX system (like SunOS) to another such machine 

telnet from one machine to another machine (which may have 

a different operating system) on a network using the 
telnet Protocol. 

Additionally, Chapter 5 discusses tip, a program for establishing connections 
over phone lines, allowing you to log in to other machines. 

Some systems trust certain users and certain machines to log in without requiring 
a password and other security mechanisms. 



You can allow or restrict login access by other users to your machine. You, or 
your system administrator, can setup your machine so that users must supply a 
password to log in to your machine, or so that certain users from certain 
machines simply can’t log in to your machine. 

When another machine running the UNIX system 5 on your local network trusts 
your username on your machine, that machine doesn’t require that you type your 
password or undergo other security checks to log in. The system files 
/etc/passwd and /etc/hosts . equiv control the users and the machines 
that may log in to your machine and to your account. 



Before we describe the files which control access privileges, let’s consider how 
one machine finds another over the network. The /etc/hosts file contains a 
list of machines — also known as hosts — and their corresponding addresses on 
the network. (The file can also contain any optional nicknames for machines.) 
Your own machine’s address is stored here. Programs use /etc/hosts to 
locate other machines for communicating over the network. 

However, if you’re running the Yellow Pages, the YP file hosts may supplant, 
or supplement, your own /etc/ hosts file; the YP hosts contains the 



5 SunOS is an enhanced version of UNIX. 
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network addresses of every machine on the network. 6 Therefore, you (or your 
System Administrator) need only maintain an up-to-date /etc/hosts file 
when the Yellow Pages are not available. 

Here is a sample /etc/hosts file: 

Figure 2-1 An /etc/hosts File 



# 

# Sun Host Database 

# 

# If the yellow pages is running, this file is only consulted when booting 

# 

127.0.0.1 localhost loghost 

# 

192.9.90.114 gaia 

192.9.90.103 venus 

v > 



/ etc/hosts . equiv The / etc/hosts . equiv file contains a list of machine names that your 

machine trusts. When a user on one of the machines in the list tries to log in or 
execute a command on your machine, your machine checks in your 
/etc/passwd file to see whether it should permit access, /etc/passwd 
regulates who can log in on a machine; it contains information about users, 
including their usernames, their passwords, their ID numbers, and so on. 7 

If that person’s username is in /etc/passwd, then your machine checks 
/etc/hosts. equiv. If it contains the name of the machine that he or she is 
using, then your machine allows him or her to log in. If the username isn’t there, 
then he or she is prompted for a password. 

Here is a sample / etc/hosts . equiv file that permits any users on machines 
gaia, pluto, and verlaine (who also appear in your /etc/passwd file) 
to log in or execute commands on your machine from their machine. 

Figure 2-2 



Note: You must be root to modify 
this file. See Doing More with 
SunOS: Beginner's Guide for informa- 
tion on becoming root. 



/etc/hosts .equiv File 



/ 

venus%. cat /etc/hosts .equiv 






gaia 






! pluto 

•; veriaiiife : v . 






venus % 






ki ; ■Zg&MZm : ■■■ v i •••■ X •• ■ :? ' •: M 




iil 



If your system supports the Yellow Pages, you may put a single plus sign (+) all 
by itself in your /etc/hosts . equiv file. This signals that anyone on the 
network served by the Yellow Pages (who is also named in /etc/passwd) 



6 Not every system tuns the Yellow Pages; not all that douse the hosts scheme. 

7 For more information about the / etc/passwd'file, see the chapter on processes and other users in Doing 
More with SunOS: Beginner’s Guide ; see the SunOS Reference Manual ; or type man 5 pasewd. 
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may log in to your machine without providing a password. As a matter of fact, 
/etc/passwd also uses the plus sign convention, so you can thus allow every- 
one on the network access to your machine. You can also selectively bar some 
people in the Yellow Pages database from logging in to your machine. 

You can further restrict other people’s access to your machine with the 
. rho st s file, located in your home directory. For more on . r ho s t s and 
/etc/hosts . equiv, seethe SunOS Reference Manual, the System and Net- 
work Administration manual, or type man hosts . equiv. 

rlogin logs you in to other UNIX machines on a network. 

Type rlogin and the machine name of the other machine. Should a password 
prompt appear, type your password for that machine followed by I Return I . If 
your machine’s name is in the other machine’s /etc/hosts . equiv file, then 
the other machine trusts your machine name and won’t require you to type your 
password. 

Figure 2-3 rlogin: Logging In to Another Machine 

— — — ■ . . .•■■■■ . ~~~~~~~~~~~~ ~ ~ — "”~T7” - ~ ~ - ^ 

venus % rlogin jupiter 
Passwords (.Here you type your password . ) 

Last login;; Mon Oct 20 00:30:52 from verius 

SunOS Release 4 . 0 (SUN) #9: Sat Nov 1 6 12:51:59 PST : 1985! 

•jupiter% pwdV 
/hame/medi c iv" : 

: jupiter% logout 
Connection closed. 

: venus% . ; ■ 



2.2. Remote Login With 

rlogin 

Logging In to Another 
Machine With rlogin 



rlogin to a Machine Where 
You Don’t Have a Home 
Directory 



Figure 2-4 



yeriius% rlogin neptuna" ; ; 

Password: 

No directory! Logging in with home=/ 

Last login: Mon Nov 25 16:58:57 from venus 
SunOS Release 4.0 (SUN) #9: Sat Nov 16 12:51:59 RST 1985 
Vhd^une%; ; ' pwd , . •' 

111 |!!||;||| !|i;;!||||||l II II# |l||||| ill III || 1 1 : 

: neptiin e% •• logout • 

Connect ion closed. . ' : : 

; venu s % .. • • • . • . • i \ ' . 

j ^ ^ •! ^ :• ^ ^ ■ j. . '• , j.!".:' _> 



In Figure 2-3 user medici logged in to jupiter at the directory 
/home/medici, as indicated by the pwd command. When you log in to a 
machine where you don’t have a home directory, rlogin displays a 
notification that you have no home directory on that machine, and logs you in to 
the root directory (/) of that machine. 

rlogin: Logging In to a Machine Without a Home Directory 
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rlogin as we’ve described it above allows you to log in to another machine, 
but under your own username. From time to time you may want to log in as 
someone else, so that you can fully manipulate files on the remote machine. One 
example of this would be when you’re off working on someone else’s machine 
(and using their username) and you want to log in to your own machine as your- 
self. The -1 option to rlogin allows you to do this. The format is as follows: 

rlogin machine-name -1 username 

For example, here’s how user medici on machine venus logs in on machine 
aphrodite as cosimo: 

Figure 2-5 rlogin : Logging In to Another Machine With a Different Username 



venus% rlogin aphrodite -1 cosimo 

Password:' if. j: -l" I; - if; ' : . : f Iff' •' f • 

Last login: Tue Nov 26 00:02:00 from venus 

SunOS Release 4.0 (SUN) #9: Sat Nov 16 12:51:59 PST 1985 

aphrodite% pwd 

/home/cdsimo 

,aphrodite% logout 

.Connection closed. :■ 

: venus%. f 



rlogin to a Machine As 
Someone Else 



Note that when you log in as someone else, you go to that person’s home direc- 
tory. 



rlogin to a Non-Existent If you attempt to log in to a machine whose name isn’t known to your machine. 

Machine say the machine andromeda, rlogin searches unsuccessfully through the 

hosts database for that machine, then displays the following notification: 



Figure 2-6 rlogin: Logging In to a Non-Existent Machine 



f .V : - .f,:,;: . : , ; f f •/; • . • 

' ve.nus% rlogin androineda 


\ 


andromeda:; unknown host 




venus % 




i:: • : ~ 


j 



If you see any error messages that you don’t understand, try looking at Table 4-1 
in Section 4.4, which contains solutions to common networking problems. 



Aborting an rlogin 
Connection 

Note: Usually you abort an rlo- 
gin connection only when you can’t 
terminate the connection using 
logout at the end of the work ses- 
sion. 



To abort an rlogin connection, type a tilde character followed by a period 
character (~ . ) at the beginning of a line. The login connection to the other 
machine aborts, and you find yourself back at your original machine. 

When you log in to a series of machines, accessing each machine through 
another machine, and you use “ . to abort the connection to any of the machines 
in the series, you return to the machine where you started. 
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Suspending an 
Connection 



Figure 2-7 rlogin: Aborting a Connection 

A.';'-. ; V.,.,... , •• ,v ••• ...... 

verms% rlogin comet 

Last login: Thu Nov 21 05:04:03 from venus 

SunOS Release 4.0 (SON) #9: Sat Nov 16 12:51:59 RST 1985 

comet % (Sometimes r doesritecho,) 

Closed connection. 

verm s % - i ; | ; £§£§:; |§ M; : V |y y: f yiy: : , ;!) yl; -y-M W y y' : f’ -y;/ *y i> V ... 

V__ ... _ 

To disconnect to an intermediate rlogin, use two tildes (~ ~ . ). For example: 



Figure 2-8 Aborting to an Intermediate rlogin 



: ■ \ 

venus % rlogin comet 
' comet % rlogin jupiter 
jupiter% " . . (Sometimes ~~ doesn’t echo .) 
comet % 

/ 



rlogin When you want to suspend an rlogin connection, so that you can return to it 

later, type the tilde character (~) followed by I Ctrl-Z 1 . The rlogin connection 
becomes a stopped process, and you are put back into the machine you logged in 
from. To reactivate the connection, type f g, or % followed by the job number 
of the stopped process (default job number for % is the job you most recently 
stopped or put in the background). 8 



Figure 2-9 rlogin ; Suspending a Connection 

r ~ ...... . ~ “ M “ . „ “ ~ “ : ’ “ 

: venus % ; rlogin aniniiatiozi ' • 

Last login: Thu Nov 21 07:07:07 from venus 

SunOS Release 4.0. (SUN) #9: Sat Nov 16 13:21:24 PST 1985 

animat ion% ~ (Sometimes doesn’t echo on the screen.) 

Stopped 
venus% pwd 
/home/medici 

venus% % 

r 1 ogin titan (Type ( Return ) here to get the command prompt \) 

animation% logout 
Connection closed ♦ 
venus% . 

V--- - -V 



As is the case with aborting rlogin with ~ ~ , using two tildes and a I Ctrl-Z I 
will suspend you to an intermediate rlogin. 



8 For more information on running jobs in the background, see the chapter on timesaving features in Getting 
Started with SunOS: Beginner's Guide and the section on job control in the chapter about the C shell in Doing 
More with SunOS: Beginner’s Guide. 
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It can sometimes get difficult to remember just who and where you are. (Not just 
in logging in to other machines. In life, too.) SunOS probably can’t help you 
much with the latter, but in the case where you have logged in to other machines, 
and perhaps logged in as someone else, and perhaps done so serially from remote 
identity to remote identity, we offer the following command: 

who am i 

who am i displays the machine you’re logged into, along with your current 
identity. (It also gives you the name of your terminal or workstation and the 
time.) Best of all, you can play pretty fast and loose with the syntax of this com- 
mand: 

Figure 2-10 Discovering Your True Identity 

venu s% r login tripod =1 billyboy 

Pa s s wq rd : V-. . •• ; . ■ • . : • ;• •" ■’ •; ' : V • ; : v v V • ; ; ! ' . , • . ‘ . .• • > • ■ . . • . • • •/ ‘ • • 

Last login: Tue Nov 26 00:02:00 from portnoy 

: St ■ 4 . 6 k ; < SON|j; : : ; #9: Tue = Nov ‘ 17 : :2 f :: TO' YS 1; PST ' 1 987 ; 

tripod% who oata trash 

tripod! billyboy tty3 Nov 20 20:07 
. tr±pod%- logout • 

Connection closed. 

•••Venu s% ' :: who .kilied vWi a.i J;' - : ..•■ • • • • 

’ vent S ! medi ci- :• • . Ytty 3 : Nov ^0 20:08 . . . ; 

venus% 

• • : : : — J 

For further information about r login, see its Man Page, online or in the 

SunOS Reference Manual. 



Verifying Your Identity with 

who am i 



2.3. Remote Login With Because you can log in from one UNIX system machine to another such machine 

telnet with rlogin, you need to use telnet only when you want to log in to a 

machine running another operating system. 9 

Therefore, telnet is most useful when your machine is on a network with 
machines that run other operating systems. 



Logging In to a Machine 
Running Another Operating 
System With telnet 



For example, to log in to machine tops 2 0, running the TOPS20 10 operating sys- 
tem, type telnet, followed by its machine name. After telnet notifies you 
of the connection with the other machine and identifies your escape character, 
try logging in to the machine as you ordinarily would. 



9 You may have to use telnet to log in to machines running varieties of the UNIX operating system that 
aren’t compatible with the current version of the Berkeley UNIX operating system (BSD). 

10 TOPS20 is a trademark of Digital Equipment Corporation. 
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Figure 2-1 1 telnet : Logging In to a Machine Running Another Operating System 




t e lnet to a Non-Existent If you attempt to log in to a machine that isn’t a part of your network, say the 

Machine machine andromeda, telnet searches unsuccessfully through the hosts 

database for that machine, then displays a notification to that effect and a prompt. 
Exit from telnet by typing quit, or the abbreviation q. 

Figure 2-12 telnet : Logging In to a Non-Existent Machine 




If you see any notifications that you don’t understand, look at the telnet Man 
Page, online or in the SunOS Reference Manual. 



Aborting a telnet 
Connection 

Note: Just as with rlogin, one 
aborts a telnet connection only 
when one can’t terminate the con- 
nection using logout at the end of 
the work session. 



When you want to abort a telnet connection, type the telnet escape char- 
acter (usually I Ctrl-1 1 . press the I Ctrl I key and the close-bracket key simultane- 
ously), followed by quit to the telnet> prompt. The login connection to 
the other machine aborts, and you find yourself back at your original machine. 11 



11 When you log in to a series of machines, accessing each machine through another machine, and you abort 
the connection to any of the machines in the series, you return to the machine where you started. 
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Suspending a 
Connection 



Figure 2-13 telnet : Aborting a Connection 

(* - \ 
venus% telnet tops20 

Trying. . * 

Connected 1 6: : tops2 0 ^ ^ •• £ :N :; - • ' V. 

Escape character is 



Ydybdyne Corp* , TOPS^^Q! Monitor 6 . 1 ( 67 62) >4 . 

,«LCtt MEDICI . . 

$ /Type ( CMd 1 to vet telnet > prompt.) 

telnet> quit 

venus% 

v : '• : : • ' • : : : • : l ^ ^ ~ • • • • : ^ : ■■ : • ' - : : ~ ~ •*' v;: • • • • •• • • • • • • • ■ ' - ~ • •• •: ' J 



telnet When you want to suspend a telnet connection, so that you can return to it 

later, type the standard escape character (usually I Ctrl-1 D followed by z to the 
telnet> prompt. The telnet program becomes a background process. To 
reactivate the connection, type fg, or % followed by the job number of the 
background process (default job number for % is the job you most recently put in 
the background). 12 



12 The z command only works with the C shell (csh). For more information cm running jobs in the 
background, see the chapter on timesaving features in Getting Started with SunOS: Beginner’s Guide , and the 
section on job control in the chapter about the C shell in Doing More with SunOS: Beginner’s Guide . 




Revision A of 9 May 1988 





Chapter 2 — Login Access to Other Machines 1 9 



Figure 2-14 telnet: Suspending a Connection 




For further information about telnet, see its Man Page, online or in the 
SunOS Reference Manual 
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Mounting Remote Filesystems 



You may very often find that you have a need to access programs which are 
located on another machine. Many times it is not practical, because of space lim- 
itations, to copy the files you need over to your machine. For this reason, NFS 
(described in Chapter 1) offers you the ability to mount other filesystems, allow- 
ing you to access files on other machines as though they were on your own. 

For example, if your company had a lot of software which everyone used, such as 
spreadsheets, demos, and text editors, a lot of valuable storage space would be 
taken up if each user had to have his or her own copies of all the programs. Peo- 
ple could use r login to access other machines, but this would be unsatisfactory 
if they had to do so every time they wanted to run a program. What your com- 
pany could do, though, would be to put the relevant files on one host (also known 
as a server) and have users mount the filesystem containing those files. 

Sun386i users can overlook this material, because, on Sun386i systems, the auto- 
mounter (described in Section 3.4) automatically mounts required filesystems for 
the user. 

3.1. The mount Suppose your company’s demos are located in /usr /demos on a server called 

Command slugf e st . You create (or have your System Administrator create) a directory, 

/usr/ demos, on your own system. This / usr /demos is called a mount 
point ; you then use the mount command to create a sort of invisible connection 
between / usr/ demos on slugf est and your / usr/ demos mount point. 

As long as you maintain the mounting, every time you refer to /usr /demos, 
you access the one on slugf est . You access slugf est ’s / usr/demos as 
though it were on your own machine — you can list its contents with 1 s, cd in 
and out of it, view its files with more, run its programs, and so on. Mounting 
allows you to do all of this without having to rlogin in to slugf est. 



Note: You must be root to use 
mount . See Doing More with 
SunOS: Beginner's Guide for informa- 
tion on becoming root. 



Use the mount command to mount other filesystems. The general format of the 
command is 

mount machine-name: filesystem directory 

where machine-name is the name of the remote machine which contains the 
filesystem you want to access; filesystem is that remote filesystem; and directory 
is a directory on your system. (It is, in fact, the mount point). Here’s how you 
would mount /usr/ demos and view its contents: 
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Figure 3-1 Mounting Remote Filesystems 



.veniis# mount 


s lugfest t/$sr/ demos 


/usr/demos 




venus# Is /usr/demos 
Readme. goban canvas_demo 


globef rames j " 




SRC 


cursor__demo 


jumpdemo 




bouncedemo 


framedemo 


spheresdemo 




venus# . 

’• 






J 



You do not have to mount a remote filesystem to a filesystem of the same path- 
name. In other words, you don’t have to mount /usr/demos on slugf est to 
a directory called /usr/demos on your machine. You can mount it to any 
directory you want. In fact, since most users aren’t allowed to create directories 
in /usr, you could, for example, create a subdirectory dem in your home direc- 
tory and mount /usr/demos there (assume /home/art/medici is your 
home directory): 



Figure 3-2 Mounting to A Different Directory 



Use su to become root. 



• • venus % • i^diir 


/home/ 






iliiiiiiii* 








Password; . . 


(Type root' s password here, ) ■ 




venus # mount s lugfest - : /usr /demos , 


^hpxrie / art /medici /dem 




venus# 


{Type 1 Of-D i to stop being root ) 




venus% Is /home/art/medici/dem 






Readme ♦goban 


; is • •; demo 'v , " ;; 


gldbef rames • • 




SRC. 


cursor_demo 


jumpdemo 




bouncedemo 


framedemo 


sphe re sdemo 




venus% . 

V 






mm 



The important thing is that you make sure that there’s a mount point on your sys- 
tem to mount the remote filesystem to. Suppose you try to mount /usr/demos 
to a directory, /usr/showme, without creating /usr/showme first. You’ll 
get an error like this: 



Figure 3-3 Mounting to a Nonexistent Directory 



verms# mount slugf est : /usr/demos /usr/showme 

mount : slugfest :./ usr /demos on /usr/showme : no buch ' 

file or directory 

mount: giving up on /usr/showme 

venus# 

! 



3.2. The /etc/ f stab 

File 

Note: you must be root to modify 
your /etc/f stab file. 



Rather than having to use mount for every filesystem you want to mount, you 
can make use of the file f s t ab which is located in the directory /etc. 13 



13 fstab stands for “file system table.” 
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f stab is a table of filesystems you want to mount, with any filesystem options 
you want. Every time your system is booted, it checks f stab to see what 
filesystems to mount. This can save you considerable time over using the 
mount command directly for each filesystem you want mounted. 

The general format of an entry in an f stab file is 

machine: filesystem directory type option freq pass 



where 

machine filesystem 

is the remote filesystem you want to mount and the machine on which it is 
located 

directory 

is the directory on your system you want to mount it to 

type 

is the filesystem type, in this case nfs 

options 

are the filesystem options, such as those described in Section 3.3 

freq 

is the number of days between dumps 

pass 

partition check pass number 
Here’s an example of an /etc/f stab file: 

Figure 3-4 A Sample fstab File 



/ 

dirt : /export /root /venus 


/ 


nfs 


rw 


0 


0 


dirt : /usr 


/usr 


nfs 


ro 


0 


0 


dirt : /home /dirt 


/home /dirt 


nfs 


rw 


0 


0 


moon : /usr/spool/news 


/usr/spool/news nfs 


ro, soft,bg, intr 


0 


0 


anchor: /usr /games 


/usr/games 


nfs 


ro, soft , bg, intr 


0 


0 


boodle : /usr/boodle 


/usr/boodle 


nfs 


ro, soft , bg, intr 


0 


0 


boodle : /usr/man 


/usr/man 


nfs 


ro, soft,bg, intr 


0 


0 


boodle: /usr/tools 


/usr/ doctools 


nfs 


rw, hard,bg, intr 


0 


0 


capulet : /usr /demo 


/usr / demo 


nfs 


ro, soft , bg, intr 


0 


0 


olympia : /usr / doc 


/usr/doc 


nfs 


ro, hard,bg, intr 


0 


0 


olympia : /usr /olympia 


/usr/olympia 


nfs 


rw, hard, bg, intr 


0 


0 


buoy : /usr /buoy 


/usr/buoy 


nfs 


rw, hard 


0 


0 


yow: /usr/src 
v 


/usr/src 


nfs. 


ro, soft, bg, intr 


0 


0 



The umount Command umount unmounts file systems which you have previously mounted, umount 

works similarly to mount; however, you only need to specify the mount point on 
your system when using it. You do not need to mention the remote machine it’s 
mounted from. So, for example, to unmount /usr/ demos, which we mounted 
in Figure 3-1, you would type as follows: 
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Figure 3-5 Unmounting a Filesystem 




As with mount, you must be root to use umount . 



There are various ways to use mount and umount. A few of the more com- 
mon ways are given here. Please note that you can combine a number of these 
options; for the exact syntax, consult the SunOS Reference Manual or type man 

mount. 

(with no options) 

mount with no arguments displays what you currently have mounted. You 
do not have to be root to use the mount command this way. 

-p (“Print.”) mount displays a list of mounted filesystems in the format used 
in f stab. You don’t need to be root to use mount this way, either. 

-v (“Verbose.”) Displays a message indicating each filesystem in 

/etc/f stab being mounted as it occurs. This option is also available 
with umount. 

-a (“All.”) mount will attempt to mount all the filesystems in 
/ etc/f stab. 

filesystem 

or 

directory 

If you use mount with either the name of a filesystem to be mounted or 
the name of one of your directories to mount to (but not both), mount 
searches f s tab for the corresponding entry and mounts the filesystem as 
indicated therein. Also true for umount. 

-h host 

(This is a umount option.) umount unmounts all the filesystems which 
are remote-mounted from the server host . In Figure 3-4 there are a number 
of filesystems mounted from the server boodle ; to unmount them, you would 
give a command like this: 

Figure 3-6 Unmounting Selected Filesystems 




Filesystem Options -o options 

There are a number of filesystem options to mount. These affect the access 
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you have to the remote filesystem, and the manner that mount goes about 
trying to mount the system. These are some of the more common filesystem 
options: 

hard or soft 

If you soft-mount a remote filesystem, mount will try up to a certain 
number of times, and then give up, returning you an error message; 
when you hard-mount it, mount will continue trying the mount until it 
is successful. 

There are advantages to both hard- and soft-mounting. Hard-mounting 
ensures that mount will not give up on a server which is only tem- 
porarily inaccessible, but will eventually connect you. It is a good idea 
to always hard-mount filesystems which you write to; that way you 
lessen the chance of data being lost during a write operation. On the 
other hand, if you are hard-mounted to a server which crashes, your sys- 
tem may hang up while waiting to connect with the remote server. 

bg or f g 

You can specify whether you want mount to retry failed mounting 
attempts in the background or the foreground. When a mount occurs in 
the foreground, the shell is tied up until the mount succeeds; if you ran 
the mount in the background, the shell and you can do other things dur- 
ing the mount attempt. 

rw or ro 

You can mount the other filesystem as read-write or read-only. It is a 
good idea to mount other systems as ro if you are only going to access 
their files and programs, not write or change them. 

intr 

If you hard-mount a filesystem, intr allows you to interrupt the mount 
from the keyboard (with [Ctrl-C I s ). 

For information on other filesystem options, see the SunOS Reference 

Manual. 

Remember, you can combine various options when using the mount command 
— see the SunOS Reference Manual. 

3.4. The Automounter Just as the mount command lessens the need to rlogin in to another machine 

every time you want to access its files, the automounter lessens the need for 
hand-mounting remote systems. The automounter mounts remote file systems 
“on the fly”; that is, it creates a temporary mount point in / tmp_mnt for you, 
mounts the remote system, and unmounts it automatically. It does so without 
your having to change your f stab file. In fact, you do not need to become 
root to dynamically mount and unmount remote filesystems. 

The mounting takes place invisibly when you refer to the remote filesystem is a 
unique way. Thus, you can cd to a remote directory, Is its contents, more a 
file on another machine, and so on, all without having to mount anything first. 
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The automounter finds the remote machine and filesystem by using either a file 
on your machine or a Yellow Pages map. The syntax for using the automounter 
can vary from site to site, or machine to machine. Here is a general example of 
how it is used: 14 

Suppose your site uses the Yellow Pages host s and passwd databases. These 
contain the addresses of machines on the network, and the list of users and their 
home directories, respectively. First, you would start the automounter daemon 
with a command line similar to this: 



Figure 3-7 



You must be root to start the auto- 
mounter. Many people have the 
automount daemon start up when 
they boot their system, by modifying 
their /etc/rc. local file Consult 
your System Administrator. Now a reference to / net / machine / filesystem will cause the automounter to 

automatically mount filesystem from the machine machine. For example, in Fig- 
ure 3-8, the command Is / net/ jupiter/ var/ spool causes the auto- 
mounter to mount /var/spool from the machine jupiter, and Is lists its 
contents: 



Starting the Automounter 

r-.;: | . . | •./ , , ... | .. ,y .. lf|| . , . •... 

venus# ahtomount; i -m /net ghosts /homes -passwd 

venua# 

/ 



Figure 3-8 Using the Automounter: I 

f venus % Is /net / jupiter/ var/spool ■ 



cron • 




ppd 


uucppubiic 


ipd; p 


mail 


;;rwho •’ • 


vpd . 


ipd;.:... 


mqueue 


secretma.il. 




lpd.Tock/ ; 


• news v . . 


. :uucp 




venus % :: 









Likewise, a reference to /homes /username causes the automounter to mount 
the home directory of the person with the username username. Using this syntax, 
cat displays the contents of the file rhyme . file in bcleaver ’s home direc- 
tory: 



Figure 3-9 Using the Automounter: II 

( 'N 

vetius% cat /homes/bcieiaveE/rhyine.file 

' A man , he /Lived • by the sewer ■; ; 

And by the sewer he died 
And at the coroner's inquest 
They called it sewer-side, 
ve nus % ■]: . 

- : • •• : : . • - - : _y 



14 Because each site running NFS is unique, consult your System Administrator on how to use the 
automounter. 
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If you go a specified period (usually five minutes) without accessing the remote 
filesystem, automount unmounts it for you. 

For more information on using the automounter, type man automount. 

3.5. Who’s Mounting This The showmount command gives the opposite information from typing 

System? showmount mount. It gives information about who has mounted filesystems from a particu- 
lar server. 

For example, let’s assume that user michael on the machine yazoo has 
mounted /usr/games from the server slugf est; reed on zippy has 
mounted /usr/demos from the same server, and roger, on yow, has 
mounted /usr/tools. 

The -a option displays all the remote mounts in the form hostname directory. 
Figure 3-10 showmount -a 
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Issuing Commands to Remote Machines 



Your Sun Workstation supports many programs that execute commands on other 
machines while you are logged in on your own machine. You can use these pro- 
grams to: 

□ Obtain status information (rup, ping, and perfmeter) 

□ List user information (rusers and finger) 

□ Copy files or directories (rep and ftp) 

□ Execute commands (rsh) 

In addition to describing these functions, this chapter provides examples of error 
notifications common to network use, and solutions for, or explanations of the 
problems they represent. 



4.1. Status Information: 

ping, rup, and 
perfmeter 

Dead or Alive: ping 



ping, rup, and perfmeter provide status information for other machines. 



ping checks to see if another machine is up and running or not. ping is useful 
because it’s a quick way to determine the status of another machine before you 
try to access it, or if you’re having trouble accessing it. The ping command 
takes the form 



ping host timeout 



where host is the machine you’re testing, timeout is an optional amount of time 
you want ping to try for. If you don’t include timeout , ping will try for 20 
seconds, or until it gets an answer. 



Figure 4-1 Using ping 



WmmxmMtMmi :* mmrnmsMmmimM- m t mm 

venus% ping pong 




pong is alive 




venus % 





33 Revision A of 9 May 1988 




34 Using the Network 



Remote Uptime: rup To find out the length of time a system has been ‘ ‘up and running,” and to view 

its load average, type rup followed by the machine name of the desired 
machine. 



Figure 4-2 rup: Uptime and Load Average for a Specific Machine 

Note: rup stands for remote 
uptime, a version of the uptime 
command that runs uptime on 
other machines. 



To get the same set of information for all of the machines that are “up and run- 
ning’ ’ and on your local network, type rup without any arguments: 

Figure 4-3 



rup: Uptime and Load Average for the Machines on Your Ethernet 

r . ■ . ,,v: 

venus% rup j 



mercury 




1 day, ‘23:31, • ■; 


: .:;idad : 


average:' 


01 0-4v 


;oo. 


o.oo 




i|ug§ 


. . 8 ; days-/ M kill 




layer age : 




W&P 


: : Q:v02 


earth 


; wp 


3 days, ‘20:44, • 


: 


^average:. 




: :0".90/ 


5;&| 


• mars 


ill! 


.mins ',' 


:; : ;igad;; 


average : 


0.01, 


O'. 00, 


d. : oo 


Jupiter ' 


ill! 


•20 : 30, 


Vhgadj: 


average! 


0.52, 


0.20, 






lllll 


8 days, 18:29, 


•load 


average ; 


1.27, 


M-ifP 


1.00 


neptune:/: 




2 days, 2:38,-. 




average: 


2.2?/'; 


1.73, 


•1/18 


Uranus 


• up 


1 day, . 3:19/ 


liipaid; 


average:- 


0.64, 


0.90, 


•i.0'4 


pluto’ 


§§!!! 


1 day, 5:47, 




average: 


3 : . 64, : 


- : 3153, 








ver*us% rup pluto 

pluto ••' up 1 day, 5:47, load average: 3.64/ 3*53, 2.80 
venus% . 

V > 



To find out more, see the rup Man Page, online or in the SunOS Reference 
Manual. 



Performance Meter: 

per f meter 

Note: You can only use perfme- 
ter when running SunView, Sun’s 
window system. 



perfmeter gives a visual readout of the status of a machine — yours or some- 
one else’s. It can tell you how busy someone is; for example, if a machine seems 
to be inactive, its owner may be away from his or her desk. Here’s how a user 
might run perfmeter: 



Figure 4-4 perfmeter 




In Figure 4-4, the user has five versions of perfmeter running. The three on 
the left give the user information about his or her own machine: the one labeled 



cpu shows how much of the machine’s central processor is being used; pkts 
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indicates how much information is going over the network; and load shows the 
average number of runnable processes in the last minute. The perfmeter 
display second from right show the central processor activity for the remote 
machine bird, while the little tombstone figure on the far right shows that 
machine dalkey is not running, perfmeter displays other useful informa- 
tion; to find out more about it, see the S unView 1 Beginner’s Guide, and the 
perfmeter Man Page, online or in the SunOS Reference Manual. 



Remote User Information rusers tells you who’s logged on to other machines on your network. The 

With rusers command rusers by itself shows each machine on the network, followed by 

the users on that machine: 



Figure 4-5 rusers 



Note: rusers stands for remote 
users, a version of the users com- 
mand that runs users on other 
machines. 



f ... ,. . 

venus % rusers 

homeplate 

absalom 


billyb 








baby Ion 


manchiid 








garden 
texas 
venus %. 


russell 
ho us ton 


cousy 


havilcek \ 





Note in Figure 4-5 that machine garden has three different users on it. 

If you wanted information on just one machine, you would type rusers fol- 
lowed by the machine’s name: 



Figure 4-6 



rusers for a Specific Machine 



venus % rusers garden 

garden russell cousy havilcek 

venus % 

-■ - ""i' ’ V ■ : Vy ;:Q- : ■.■Vii.il'g- .V ■ ^ ^ > 



For more detailed information, there’s the -1 option, which gives the username, 
the machine and terminal names, the time the user logged on, how long the 
users ’s been idle (if more than one minute), and the name of a machine that the 
user rlogged in from, if any: 



Figure 4-7 rusers: Detailed Information 
venus % rusers -1 garden 



russell 


..garden: th. ydB • 


; NOV 


ill 


09:00 


7:24 


cousy 


garden ^console 


Nov 


•is! 


16:13 




haylicek 


garden: ttypQ 


^Tbv 


Ill 


11:43 


2i (quirk) 



venus% 



The -1 option can also be used when no machine name is given, as in Figure 4- 
5. Formore information, see the rusers Man Page, online or in the SunOS 
Reference Manual. 
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The finger Command rusers is a good way of getting some information about who’s logged in on 

other machines. The finger command, though, really gives you the lowdown 
on other users. In fact, unlike commands such as ping or rusers, finger 
doesn’t give you information about other machines. It tells you only about other 
users. In fact, finger is so user-oriented that it accepts people’s real names, as 
well as their usernames, as arguments. 

Here’s what finger tells you: 

□ the user’s login name 

□ his or her real name 

□ his or her home directory and login shell 

□ the last time he or she logged in 

□ the last time he or she received mail, and the last time he or she read it 

□ the name of his or her terminal(s), and how long it’s been idle 

Here is a slightly simplified example of a two typical finger requests. Your 
output may vary somewhat. 



Figure 4-8 finger 

ITT - " T - ~ “T - — : — T 7- "" — ~ ”7“7\ 

venus % finger moby@ sea 

[sea] 

Login name : moby ' In real 1 i ife: Ishmael Wong 

Directory: /home/shipwreck/moby Shell: /bin/csh 

On since Nov 14 06:33:41 on console 4 days 14 hours Idle Time 
New mail received Wed Nov 18 20:34:02 1987; 

unread since Wed Nov 18 16:20:24 1987 
venus% finger Henry Stamper 

Login name: hank in real, life: Henry Stamper,:; Jr 

Di rectory : /home/bregon/hank Shell: /bin/csh 

Last; login Wed Oct : 21 16 :16 on ttypO from Cairo 
No unread mail;: .. 



finger is useful for making sure that the user you’re looking for is still alive 
and kicking (computer-wise, anyway), finger has various options and further 
capacities; to learn about them, see the SunOS Reference Manual, or type man 

finger. 



4.2. Remote File Copy 
With rep and ftp 

Note: If you have a filesystem on 
another machine mounted, you do 
not have to use remote copy com- 
mands to put and get files in that 
filesystem. See Chapter 3. 



To copy files from another machine onto your machine, or copy files from your 
machine onto another machine, use one of the remote file copy commands. Each 
program has a slightly different specialty for file copying: 

rep Most common, but only between UNIX system -based machines ; permits 
copying of entire directories 

ftp uses a standard, generalized protocol 
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Copying from Another To remote copy a file from another machine onto your machine with rep, use 

Machine to Your Machine the following syntax: 

Using rep 

rep machinename:file directory 



where machinename is the name of the machine you want to copy from; file is 
the file you want to copy; and directory is where you want to put the file on your 
system. 

For example, to copy a file called /home/charon/new . toy from the 
machine called pluto to the directory called /home/medici/toys on 
your machine, venus: 

Figure 4-9 rep: Copying from Another Machine to Your Machine 




You can use normal SunOS shorthand for directories (such as ~ for your home 
directory and . for the current directory). 15 When you want to call the file by a 
different name on your own machine, specify a destination filename at the end of 
the destination directory on your machine. For example, here’s how you could 
copy the file new . toy from machine pluto to your home directory and 
rename it my .toy: 

Figure 4-10 Copying and Renaming with rep 

•;: ; venxis%'; rcp-' piutoT^ - toy ~ /my /toy 

venus % 

V > 



If rep displays an error notification, see the section on error notifications (Sec- 
tion 4.4 ). 



Copying from Your Machine To rep a file from your machine onto another machine, you reverse the syntax 
to Another Machine Using above: 

rep 

rep file machinename '.directory 



where file is the file on your machine you want to copy; machinename is the 
machine you want to copy to; and directory is the place you want to send the file 
to. 

For example, to copy a file called /home /medici/old. toy from your 
machine to the directory called /home/charon/trash on the machine 



15 For a description of these naming conventions, see the Doing More with SunOS: Beginner's Guide. 
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pluto : 

Figure 4-11 rep: Copying from Your Machine to Another Machine 




When you want to call the file by a different name on the other machine, specify 
a destination file at the end of the destination directory on that machine, as in 
Figure 4-10. 

If rep displays an error notification, see the section on error notifications (Sec- 
tion 4.4 ). 



Copying Directories With To copy a directory and its contents from another machine to your machine, or 

rep vice versa, use rep with the -r option. Then, follow the steps for copying 

files, only replace the filenames with the appropriate directory names. 



Warning: copying directories with 
rep doesn’t preserve permission 
and ownership settings. 



To copy a directory and its contents from another machine to your machine, type: 
rep -r machine-name:directory local-directory 



(Where machine-name is the name of the remote machine; directory is the direc- 
tory on that machine that you want to copy; and local-directory is the directory 
on your machine you want to copy to.) 

To copy a directory and its contents from your machine to another machine, type: 

rep -r local-directory machine-name'.directory 

(Where local-directory is the directory on your machine you want to copy and 
directory is the place on the other machine you want to copy to.) 

Like rlogin, rep uses the other machine’s /etc/hosts . equiv and 
/etc/passwd files to determine if you have unchallenged access. 



Copying from Another 
Machine to Your Machine 
Using ftp 



To copy a file from a machine that isn’t necessarily running a version of UNIX 
operating system, use ftp, the file transfer program. Here are the steps for 
copying a file from another machine to your machine using ftp: 

□ Type ftp to start the program. 

o When you see the ftp> prompt, type open followed by the machine 
name of the other machine. 

□ Wait for ftp to establish a connection. 

□ Type your username on the other machine to the Name prompt. 

o Type your password on the other machine to the Password prompt. 
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a Wait for ftp to log you in to the other machine. 

□ When you see the ftp> prompt, type get, followed by the filename (use 
absolute pathname) of the file on the other machine, and the destination 
filename (absolute pathname) where you want the file to appear. 

□ When ftp notifies you that the transfer is complete, type quit to close the 
network connection. 

Figure 4-12 ftp: Copying from Another Machine to Your Machine 

:' ; r. : . . v. x. . • ~Ti. .. .A 

•: , . ; • vGnu s %• ftp v :i?l: !: :? : *i i *ii : ' ■■■. ■■■■ ■ • -Y •• / : 

£tp> open plutp 

• Cd&Ttected to pinto. ' • 

220 titan' server • (Version- 4. 12$ Nqv 2 13:01:21 £Sl 1985) ready 

• Name (plutotmedici):- medici ' 

• $ as si p rd • t p : : tied: i c : £ H : Yi;Y:Y: : ••• (Type password followed by [Return] .) 

331 Password required for medici, 

:YYY:Y •• . : 2 3 Q • t) set • medid-i ;loggted: i ;h;>" ) 

ftp> get /home/medic i /new. toy /home/medici /toys 

200 PORT command okay. 

150 Opening data connection for /home /medici /new. toy . . . (176 bytes) 

£2$: -COffiple : : YxY;?*’. !, ' 

183 bytes received in 0,01 seconds (9,4 Kbytes /$) 

ftp>- :: guit ; ; • : ; : . • Y i : ' " . • : ’ ; !’ :• ' :: YY : ■; _ • V- / f • ' ' , , ’• ; : Y yYY-y : : 

venus % 

^ / 



Copying from Your Machine Here are the steps for copying a file from your machine to another machine using 
to Another Machine Using ftp: 

ftp □ Type ftp to start the program. 

a When you see the f tp> prompt, type open followed by the machine 
name of the other machine. 

□ Wait for ftp to establish a connection. 

□ Type your username on the other machine to the Name prompt. 

□ Type your password on the other machine to the Password prompt. 

□ Wait for ftp to log you in to the other machine. 

□ When you see the ftp> prompt, type send, followed by the filename 
(use absolute pathname) of the file on your machine, and the destination 
filename (absolute pathname) where you want the file to appear on the other 
machine. 

□ When ftp notifies you that the transfer is complete, type quit to close 
the network connection. 



Asun 

\r microsystems 



Revision A of 9 May 1988 





40 Using the Network 



Figure 4-13 ftp: Copying from Your Machine to Another Machine 

r : ~ • 

vemis% ftp 

ftp> open pluto 

Connected to pluto, •' 

220 titan FTP server (Version 4.125 Sat NoV 2 13:01:21 PST 1985} ready 
• Name . ' (pluto : med ic i)‘ : medic i , ^ 

Password (plutoimedici) (Type password followed bv l Return 1 ) 

331 Password required for medici, 

230 User medici logged in. 

: : .v f £&> ' send- 7bd^/jnedioi : /gl4ytd^ 

20 Q PORT command okay. 

150 Opening data connection for /home /medici /old. toy ♦ ♦ , (176 bytes) 
226 Transfer complete. 

183 bytes received in’ 0.01 seconds (5.4 Kbytes/s) 

ftp> quit 
venus% 

l- • >’ ■■■■ ' ' '• — J 

quit to close the network connection. 

Further Information For more information on rep or ftp, see their Man Pages, online or in the 

SunOS Reference Manual. 



4.3. Remote Command 
Execution With rsh 

Note: rsh stands for remote shell, 
or an interpreter capable of execut- 
ing commands on another machine. 



rsh allows you to execute a single command on another machine without hav- 
ing to formally log in. It can save time when you know you only want to do one 
thing on the remote machine. 

To execute a command on another machine, type rsh followed by the 
machine’s name and the command. For example, suppose you want to see the 
contents of the directory / home / fresno/crops on the machine f r e s no : 



Figure 4-14 Executing a Command on Another Machine 

venus% rsh f resno Is /home/ f resno/ crops 

corn . kiwi oranges 

grapes olives peaches 

venus % 

V : : > 



When you execute a command on another machines using rsh, rsh doesn’t 
log in; it talks to a daemon that executes the command on the other machine. 
However, if you have a . c shr c file in your home directory on the other 
machine, rsh reads it. So rsh uses any pertinent aliases that you have defined 
on the other machine when executing the command. 

Like rlogin and rep, rsh uses the other machine’s /etc/hosts . equiv 
and /etc/passwd files to determine whether you have unchallenged access 
privileges. 

For more information, see the rsh Man Page, online or in the SunOS Reference 
Manual. 
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4.4. Network Error 
Notifications 



This section provides a table of network error notifications and possible solutions 
for, or explanations or the problems associated with each error notification. 
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Table 4-1 Network Error Notifications : Problems and Solutions 



Error Notification 


Problem, 


Address already in use. 


Other machine is down or 
not functional 


Connection refused. 


The other machine is up, but 
its daemons aren’t ready to 
complete a connection. 


Connection timed out. 


One machine or the other is off, 
hung (stuck), or down 


File not found. 


File doesn’t exist on other 
machine. 


Host name for your address 
unknown . 


Other machine needs your 
machine name in its 
/etc/hosts file 


Login incorrect . 


You mistyped a password, or your 

username isn’t in the 

other machine’s / e t c / pa s s wd 


Network is unreachable. 


Routing problem — 
a gateway machine or other 
network connection is broken 


. . .No such file or directory 


File or directory on other 
machine doesn’t exist, or 
you don’t have read permission. 


. . . not found. 


Directory on other machine doesn’t exist 


Nothing at all 


Directory on other machine is empty 


Permission denied. 


Machine name isn’t in 
/etc/hosts . equiv file; password 
required; may need write permission 
for directory on your machine 


RP C_P MAP_F AI LURE 


Daemon not running properly 


RP C_T I ME D_OUT 


Couldn’t connect to other machine, 
it may be down 


RPCJJNKNOWNHOST 


Machine name doesn’t exist on network 


unknown host 


Other machine name not in 
/etc /host s file on your machine. 
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Using Dialup Terminals 



Note: A terminal may be a process 
running on a machine, running 
without any association to the piece 
of hardware usually considered a 
terminal. 

When you wish to establish a dialup connection from a machine that supports 
tip or cu to another machine, see the section on tip (Section 5.4 ) or the Man 
Pages, online or in the SunOS Reference Manual. 



This chapter describes how to establish a dialup connection from a terminal, per- 
sonal computer, or workstation to another machine. Because of the great variety 
of equipment involved, it is not possible to describe the process in complete 
detail, so general guidelines appear here. It also gives an introduction to the 
SunOS program tip, for establishing telephone connections between machines. 



5.1. Equipment You need two pieces of equipment to initiate a dialup connection: 

□ a terminal, workstation, or personal computer 

□ a modem (and telephone lines!) 

A hardware terminal is a keyboard and screen device that has no real CPU, or 
central processing unit, so for the most part it doesn’t support general computa- 
tion or programs. However, to establish a dialup connection to a machine, the 
computation ability available on a workstation or personal computer isn’t neces- 
sary. 

The modem is a device that permits you to transmit computer signals from your 
terminal, workstation, or personal computer through a phone line to another such 
device that translates the signals so they are again accessible by a user at the des- 
tination machine. 



5.2. Considerations Many considerations may affect your attempt to connect to a machine by dialup 

access, such as: 

o Interpretation of I Return I and I Line Feed) 

□ Xon/Xoff protocol 

□ Parity (odd, even, or no parity) 

□ 7-bit transmission versus 8-bit transmission 

Besides pointing out that the destination machine must have a modem to inter- 
pret the signals transmitted by your modem, this manual attempts to explain only 
a few details about two considerations that are especially important: the phone 
number and the baud rate. 
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Phone Number To dial up the other machine, you have to know its phone number — ask some- 

one you know or contact that machine’s system administrator. Of course, some 
machines don’t support dialup connections. 



Baud Rate The baud rate is the rate at which your terminal, workstation, or personal com- 

puter exchanges data (usually bits per second) with the machine you’re access- 
ing. The two most common baud rates for dialup connections are 300 baud and 
1200 baud. Both sides of the connection must transmit and receive at the same 
baud rate or they’ll get “confused.” 16 

Some machines set or adjust baud rates automatically. But if gobbledegook 
appears on your screen when you establish a connection to the other machine, it 
probably means that you need to adjust your baud rates for sending and receiving 
data. See the terminal, workstation, or personal computer manual to leam how to 
do so. 



5.3. The Process To dial up from your terminal, workstation, or personal computer to a machine, 

follow these steps: 

□ Power on your terminal, workstation, or personal computer and your modem 

□ Dial up the other machine by typing the appropriate commands from your 
keyboard to your modem (read the instruction manual for your modem!) 

□ Connect to the other machine (sometimes you have to type I Return ] once or 
twice to establish the connection) 

□ Log in to the other machine 

□ Complete your work session 

□ Log out from the other machine 

□ Disconnect from the other machine (sometimes you have to type an escape 
character to regain the attention of the modem) 

□ Power off your terminal, workstation, or personal computer and the modem 
(unless you use them continuously). 



5.4. Remote Login With 

tip 

Note: cu, an interface to tip 
based on what was originally a UNIX 
Version 7 command, is available. 
See its Man Page if you want to 
know more about it. 



You can use tip to log in to machines that aren’t on your local network, but are 
accessible by dialing up. tip, the terminal interface processor, lets you dial up 
other machines and establish a modem connection. 



16 A bit of trivia: the word baud originates from the name Baudot, the person who invented the Baudot 
Code. 
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Establishing a Connection To establish a tip connection, type t ip followed by the phone number of the 

With t ip machine to which you want to connect. 

Figure 5-1 tip: Establishing a Connection 




Problems Establishing a tip may fail to make a connection for one of several reasons. When the phone 

Connection With tip line is busy or doesn’t answer, tip prints the message call failed. Check 

the phone number and try again. If the problem persists, try looking at the tip 
Man Page, online or in the SunOS Reference Manual. 

Figure 5-2 tip : Call Fails 




Sometimes the system at the other end of the phone line may not respond prop- 
erly. Perhaps it is down temporarily or has some kind of maintenance problem. 
Contact a user on the other system, or its system administrator, to correct the 
problem. 

When the local machine is loaded with many processes, tip may not be able to 
synchronize with a modem to connect with the other machine. Try again, and if 
that doesn’t work, wait until the system is less loaded. 

Figure 5-3 tip: Synchronization Problem 
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Command Summary 



This is a summary of all commands mentioned in this manual. Each command 
appears in alphabetical order by name, and includes a syntax diagram, and a brief 
paragraph describing its function. 

finger finger name 

Gives information about the user named by name, name can be a 

person’s username or real name. 

ftp ftp 

File transfer program that includes commands: 

get get filename local-filename 

Transfer file filename from the machine to which a con- 
nection is open to this machine and call it local-filename. 

open open machine-name 

Establish a connection to machine-name. 

quit quit 

Quit ftp. 

send send local-filename filename 

Transfer file local-filename from this machine to become 
file filename on the machine to which a connection is 
open. 

mount mount 

Display all mounted filesystems. 

mount machine-name filesystem directory 

Mount the specified filesystem filesystem on machine machine-name 

to directory directory. 



mount options 

-a Mount all filesystems in / e t c / f st ab. 

-p Print all mounted filesystems in a format 

useful to /etc/fstab. 
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-v Display mounts as they occur. 

-o option Mount the filesystem according to option. 

Valid options include bg/f g (background 
vs. foreground); ro/rw (read-only vs. 
read-write); hard/ so ft (retry on error or 
not). 

mount [filesystem I directory ] 

Mount the remote filesystem filesystem to directory as indicated in 
/ etc/f stab. 

perfmeter 

perfmeter [ machine-name ] 

Provides status information window for this machine or the machine 
specified by machine-name. Runs under SunView. 

ping ping machine-name 

Tells whether another machine is running or not. 



rep 


rep local-filename other-machine-name : destination-filename 
Copy file from local- filename on your machine to the destination- 
filename on machine other-machine-name (use absolute pathnames 
for files). 




rep other-machine-name : filename local-filename 

Copy file filename from machine other-machine-name to local- 

filename (use absolute pathnames for files). 




rep -r local-directory-name other-machine-name : destination- 
directory-name 

With -r option, copy from local-directory-name on your machine 
to the destination-directory-name on machine other-machine-name. 




rep -r other-machine-name : directory-name local-directory-name 
With -r option, copy directory directory-name from machine 
other-machine-name to local-directory-name. 


rlogin 


rlogin machine-name [-1 username ] 

Log in from your machine to the machine called machine-name 
using the current username; when you specify the -1 username 
option, rlogin attempts to log in with the username you specify. 
" ~ . " aborts an rlogin connection. ~ followed by 




1 Ctrl-Z 1 suspends an rlooin connection. 


rsh 


rsh machine-name command 

Execute command command on machine-name. 


rup 


rup [ machine-name ] 

Display system uptime and load average information for all 
machines on local Ethernet, or for machine specified. 


♦ sun 
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rusers rusers [machine-name] 

Display usernames of users logged in on all machines of the local 
Ethernet, or for machine-name if specified. 

showmount 

showmount machine-name 

Displays which other machines have mounted filesystems on the 
machine machine-name. 

With the -a option, gives the filesystems on machine-name which 
have been mounted on other machines. 

telnet telnet [machine-name] 

File transfer program that includes commands: 

z z 

Suspend telnet program. 

quit quit 

Quit telnet. 

I Ctrl-1 1 obtains telnet prompt. 

tip tip phone-number 

Dial up phone-number and attempt to start a login connection. 

umount filesystem 

Unmount filesystem filesystem. 

options include: 

-h host Unmount all filesystems associated with the remote 

machine host. 

-a Unmount all filesystems in /etc/f stab. 

-v Report on each unmount as it occurs. 
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Glossary 



This glossary lists network facility terms in common use, especially in this 
manual. For commands, see the command summary. Appendix A . 

absolute pathname 

For a file or directory, the list of directories from the root directory through 
the tree structure to the desired filename or directory name, each name in the 
series separated by a forward slash character (/). 

background process 

A command that you have directed the system to work on while you con- 
tinue to type commands to the command interpreter. 

daemon 

A process that runs in the background, handling commands delivered for 
remote command execution. 

dialup connection 

A connection between machines through a phone line, 
distributed file system 

A file system that exists on more than one machine, permitting easy user 
access to files on other machines. 

establish a connection 

Initiate link for transfer of data between two machines, 
gateway 

A device that transfers data from one network to another — a link between 
networks. 

job number 

A number that the system assigns to each process running on that machine. 

local area network 

A network of machines in close proximity, connected by cables. 

modem 

A device that enables a machine or terminal to establish a connection and 
transfer data through telephone lines. 

mount point 

A directory on your system to which you mount a filesystem which exists on 
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a remote machine, 
mounting a file system 

Establishing a transparent link, using the Network File System, to a direc- 
tory on another machine so that the directory appears to be on the local 
machine, and can be accessed as such. 

network 

A connection between machines, allowing them to transmit information to 
one another. There are two general kinds of networks: local networks and 
remote networks. 

Network File System (NFS) 

A set of programs that permits users to directly access files on other 
machines, and the protocol which allows that access. 

network path 

A series of machine names used to direct mail from one user to another. 

protocol 

A “language” that networks use to communicate with each other — IP 
(internet protocol), TCP, and UDP are examples. 

read permission 

An attribute of a file that permits you to read and copy the file, 
remote network 

A network other than the local, cable-connected network; it may contain a 
local network, however. 

remote command execution 

Typed instructions for a command to occur on another machine, and report 
back any output to the initial machine. 

remote shell 

A command interpreter that you initiate on one machine, but that executes 
on another machine specified on the command line. 

routing 

The process of determining a pathway for data to get from one machine in a 
network to another machine through a gateway. 

server 

1) A dedicated machine which provides files and network facilities to client 
machines; 2) Any machine which is providing files for a client machine 
(such a machine can be both a server and a client); 3) a daemon which actu- 
ally handles the providing of files. 

status information 

Information about the system, such as the system load averages, and how 
long since the last system downtime. 

suspend 

Stop a program so that one can type commands to the interpreter and later 
return to execution of the program. 
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terminal 

A process running on a machine that originates with the physical device 
called a terminal, or as a software representation of such a physical device, 
like a window. 

trust 

When a machine permits other machines and usernames access to accounts 
on that system without requiring a password or other security mechanisms. 

user information 

Information about users on a machine, such as usernames, time since log- 
ging in, and “terminal” number. 

window and mouse program 

A program that makes use of SunView, the window system and associated 
software, so that you can use the mouse to locate and select items within a 
window application on your screen. 

window-based tool 

See window and mouse program. 

write permission 

Access to a file that permits you to change the file. 

Yellow Pages 

A network database which includes information on users and machines on 
the network; also a service for looking things up in that database. 
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file system, 5 ^ 0 ?*^ 1 | 

filesystem, 5 

filesystem options to mount, 27 . 

finger command, 36 
ftp command, 38, 51 

G 

gateway, 5 

H 

hard mounting, 27 
host, 12 

Host name for your address unknown, 42 
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Internet Protocols, 5 
internetwork, 3 
internetwork protocol, 5 

J 

job number, 15, 18 

L 

LAN, 3 

load average, 34 
local area network, 3 
local network, 5 

login access to other machines, 1 1 
Login incorrect, 42 

M 

MELNET, 6 
modem, 45 

modem connection, 46 
mount command, 23 
mount point 23 
creating, 23 

mounted directories, 36 
mounting remote filesystems, 5, 23 
filesystem options, 27 
hard, 27 
soft 27 

N 

network, 5 

ARPANET, 6 
common problems, 41 
copying directory, 38 
Defense Data Network, 6 
definition, 5 
dialup connection, 46 
error notifications, 41 
internetwork protocol, 5 
local, 5 
login over, 11 
MILNET, 6 

modem connection, 46 
protocol, 5 
remote, 5, 6 

remote login, 11, 13, 16, 46 
UUCP, 6 

Network File System, 3, 36 
Network is unreachable, 42 
NFS, 3 

p 

perf meter command, 34, 52 
perf meter icon, 34 
Permission denied, 42 
personal computer, dialup connection to, 45 
ping command, 33, 52 
protocol, 5 
TCP, 36 



R 

rep command, 37, 52 
-r option, 38, 52 
remote aliases, 40 
remote command execution, 33, 40 
remote daemon, 40 
remote file copy, 36, 37, 38 
remote load average, 34 
remote login, 11, 13, 16, 46 

aborting a connection, 14, 18 
call failed, 47 

different operating system, 16 
different username, 14 
no connection established, 47 
no home directory, 13 
non-existent machine, 14, 17 
problem, 13, 14, 17, 47 
suspending a connection, 15, 18 
synchronization with modem, 47 
trust, 11 

remote network, 5, 6 
remote status information, 33 
remote system uptime, 34 
remote user information, 35 
. rhosts file, 13 
rlogin command, 13, 52 
-1 option, 14, 52 
RPC_TIMED_OUT, 42 
rsh command, 40, 52 
rup command, 34, 52 
rusers command, 35, 53 

s 

server, definition of, 58, 4, 23 
showmount command, 29 
soft mounting, 27 
status information, 33 
Sun386i, 5, 6 
system information, 34 
system uptime, 34 

T 

TCP protocol, 36 
telnet command, 16, 53 
escape character, 17 
terminal, dialup connection to, 45 
tip command, 45, 46, 53 
trust between machines, 1 1 

u 

umount command, 26 
unknown host, 42 
unmounting remote filesystems, 26 
uptime command, 34 
user information, 35 
users command, 35 
UUCP, 6 
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w command, 35 
WAN, 3 

who command, 35 

wide area network, 3 

workstation, dialup connection to, 45 

Y 

Yellow Pages, 6, 12 
YP, see Yellow Pages 
ypbind, 7 
ypserv, 7 
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5 8 Using the Network 



a remote machine, 
mounting a file system 

Establishing a transparent link, using the Network File System, to a direc- 
tory on another machine so that the directory appears to be on the local 
machine, and can be accessed as such. 

network 

A connection between machines, allowing them to transmit information to 
one another. There are two general kinds of networks: local networks and 
remote networks. 

Network File System (NFS) 

A set of programs that permits users to directly access files on other 
machines, and the protocol which allows that access. 

network path 

A series of machine names used to direct mail from one user to another. 

protocol 

A “language” that networks use to communicate with each other — IP 
(internet protocol), TCP, and UDP are examples. 

read permission 

An attribute of a file that permits you to read and copy the file, 
remote network 

A network other than the local, cable-connected network; it may contain a 
local network, however. 

remote command execution 

Typed instructions for a command to occur on another machine, and report 
back any output to the initial machine. 

remote shell 

A command interpreter that you initiate on one machine, but that executes 
on another machine specified on the command line. 

routing 

The process of determining a pathway for data to get from one machine in a 
network to another machine through a gateway. 

server 

1) A dedicated machine which provides files and network facilities to client 
machines; 2) Any machine which is providing files for a client machine 
(such a machine can be both a server and a client); 3) a daemon which actu- 
ally handles the providing of files. 

status information 

Information about the system, such as the system load averages, and how 
long since the last system downtime. 

suspend 

Stop a program so that one can type commands to the interpreter and later 
return to execution of the program. 




Revision A of 9 May 1988 





